Sentiment mạng xã hội

Mô tả API

Cung cấp dữ liệu chỉ số tâm lý thị trường của một token, bao gồm tỷ lệ quan điểm tăng giá, giảm giá, trung lập và nội dung quan điểm.

Tình huống sử dụng:

Phân tích tổng hợp tâm lý thị trường của token
Kết hợp phân tích dòng vốn để hiểu mối quan hệ giữa tâm lý thị trường và xu hướng giá
Đánh giá xu hướng tâm lý long/short của thị trường

Gợi ý sử dụng:

Khi người dùng nhập tự nhiên tâm lý thị trường, có thể gọi API này và đồng thời gọi API dữ liệu vốn thời gian thực để phân tích

Tần suất cập nhật dữ liệu: mỗi 30 phút

URL yêu cầu

Phương thức: POST
Đường dẫn: /open/v1/social-sentiment/getCoinSocialSentiment

Tiêu hao điểm tích lũy

Điểm tích lũy mỗi lần gọi: 2

Điều kiện tiên quyết

Lấy vsTokenId

Điều kiện	Mô tả	Cách lấy
Đã có `vsTokenId`	Dùng trực tiếp `vsTokenId` đã cache, không cần truy vấn lại	Tự động lấy từ ngữ cảnh
Chưa có `vsTokenId`	Gọi API `POST /vs-token/list`	Gọi API tiên quyết

Tham số yêu cầu

Truyền tham số trong body dưới dạng JSON.

Tên tham số	Kiểu	Bắt buộc	Mô tả
vsTokenId	long	Có	Token ID

Trường phản hồi

Chỉ liệt kê cấu trúc trường trong đối tượng data:

Trường	Kiểu	Kiểu thực tế trả về	Mô tả
updateTime	long	long	Thời gian cập nhật dữ liệu (timestamp mili giây)
vsTokenId	long	string	Token ID
symbol	string	string	Ký hiệu token
name	string	string	Tên token
bullishRatio	number	number	Tỷ lệ tâm lý tăng giá (0-1)
neutralRatio	number	number	Tỷ lệ tâm lý trung lập (0-1)
bearishRatio	number	number	Tỷ lệ tâm lý giảm giá (0-1)
bearishContents	array	array	Danh sách nội dung tóm tắt giảm giá
english	string	string	Nội dung tiếng Anh
updateTime	long	long	Thời gian cập nhật nội dung (timestamp mili giây)
neutralContents	array	array	Danh sách nội dung tóm tắt trung lập
english	string	string	Nội dung tiếng Anh
updateTime	long	long	Thời gian cập nhật nội dung (timestamp mili giây)
bullishContents	array	array	Danh sách nội dung tóm tắt tăng giá
english	string	string	Nội dung tiếng Anh
updateTime	long	long	Thời gian cập nhật nội dung (timestamp mili giây)

Ý nghĩa nghiệp vụ

Các trường sau cần giải thích rõ ý nghĩa nghiệp vụ:

Trường	Ý nghĩa	Phạm vi / Cách tính	Gợi ý sử dụng
bullishRatio	Tỷ lệ tâm lý tăng giá	0-1, dựa trên phân tích cảm xúc nội dung mạng xã hội	Càng gần 1 thì thị trường càng tăng giá
neutralRatio	Tỷ lệ tâm lý trung lập	0-1, dựa trên phân tích cảm xúc nội dung mạng xã hội	Biểu thị tỷ lệ tâm lý quan sát/chờ đợi
bearishRatio	Tỷ lệ tâm lý giảm giá	0-1, dựa trên phân tích cảm xúc nội dung mạng xã hội	Càng gần 1 thì thị trường càng giảm giá
bullishContents	Tóm tắt nội dung tăng giá	Tóm tắt AI từ nội dung mạng xã hội	Hiểu lý do cụ thể thị trường tăng giá
bearishContents	Tóm tắt nội dung giảm giá	Tóm tắt AI từ nội dung mạng xã hội	Hiểu lý do cụ thể thị trường giảm giá

Ví dụ yêu cầu

json

{
    "vsTokenId": 1   // Từ khóa token (vsTokenId)
}

Ví dụ cURL (Linux/macOS)

bash

curl --location --request POST 'http://${host}/api/open/v1/social-sentiment/getCoinSocialSentiment' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1
}'

Ví dụ cURL (Windows CMD)

cmd

curl --location --request POST "http://${host}/api/open/v1/social-sentiment/getCoinSocialSentiment" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1}"

Ví dụ phản hồi thành công

json

{
    "code": 200,
    "message": "success",
    "data": {
        "updateTime": 1773315931000,               // Thời gian cập nhật dữ liệu
        "vsTokenId": "1",                           // Từ khóa token (vsTokenId)
        "symbol": "BTC",                            // Ký hiệu token
        "name": "Bitcoin",                          // Tên token
        "bullishRatio": 0.4113,                     // Tỷ lệ tâm lý tăng giá
        "neutralRatio": 0.4937,                     // Tỷ lệ tâm lý trung lập
        "bearishRatio": 0.095,                      // Tỷ lệ tâm lý giảm giá
        "bearishContents": [
            {
                "english": "$BTC faces conflicting narratives...", // Nội dung tiếng Anh
                "updateTime": 1773316047000          // Thời gian cập nhật nội dung
            },
            {
                "english": "$BTC faces intense bearish pressure...",
                "updateTime": 1773314274000
            },
            {
                "english": "Whales and treasury entities...",
                "updateTime": 1773312461000
            }
            // ... bỏ qua thêm dữ liệu
        ],
        "neutralContents": [
            {
                "english": "Whales and institutional actors...",
                "updateTime": 1773316047000
            },
            {
                "english": "$BTC remains central to macro speculation...",
                "updateTime": 1773312461000
            },
            {
                "english": "$BTC faces immediate resistance at $70K...",
                "updateTime": 1773310591000
            }
            // ... bỏ qua thêm dữ liệu
        ],
        "bullishContents": [
            {
                "english": "$BTC shows strong bullish conviction...",
                "updateTime": 1773316047000
            },
            {
                "english": "Whales are driving momentum...",
                "updateTime": 1773314274000
            },
            {
                "english": "Whales are reactivating long-dormant...",
                "updateTime": 1773312461000
            }
            // ... bỏ qua thêm dữ liệu
        ]
    },
    "requestId": "xxx-xxx-xxx"
}

Sentiment mạng xã hội ​

Mô tả API ​

URL yêu cầu ​

Tiêu hao điểm tích lũy ​

Điều kiện tiên quyết ​

Tham số yêu cầu ​

Trường phản hồi ​

Ý nghĩa nghiệp vụ ​

Ví dụ yêu cầu ​

Ví dụ cURL (Linux/macOS) ​

Ví dụ cURL (Windows CMD) ​

Ví dụ phản hồi thành công ​